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2. PROGRAM TESTING 


A. GENERAL 


The purpose Of program testing is to ensure that a program, once it has been 
written and assembled, actually performs the task it was designed to accomplish. 
Program testing basically involves the evaluation of actual output values 
produced by a program in terms of expected output, and the correction of those 
portions of a program which produce any variations from expected performance. 


Program testing may be further refined to include the evaluation of intermediate 
values generated by a program which never appear on output media but which may 
eritically affect output. 


B. DIAGNOSTIC ROUTINES 


A number of diagnostic procedures, which a program may call at any point, are 
incorporated into the PAL Assembler to record on the printer intermediate and 
final results of computation or other program output. These procedures are 
predefined and do not require definition within the program using them. 


These program-testing procedures enable the programmer to evaluate the results 
produced by each logical subdivision or subroutine of his program. They provide 
the facility of testing each subroutine independently or in conjunction with the 
rest of the program. 


When all portions of the program have been tested and found to function as in- 
tended, the corrected source program is reassembled without the program-testing 
procedure calls. 
1. DUMP and SNAP 
a. DUMP Macro 
This instruction includes in the object program a routine to print 


a portion of memory. This routine can be entered only by the SNAP 
macro.* 


The DUMP instruction may have any of the following forms: 


LABEL OPERATION OPERANDS 


a 
a, b 

ag oo. 3G 
a, b, c 
, bd 

j. De SS 
eo SC 


*Performing a transfer of control on the console to the label of the | 
DUMP call will print all of memory and stop the computer. 
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A blank operand field states that there is no standard print routine 
as part of the worker program, and the DUMP routine will generate areas 
for printing and temporary storage. 


Parameter "a" is PRINT if the standard I/O print routine is part of the 
worker program and full lines are printed. 


Parameter "b" is an expression that represents an area of 128 characters 


in the worker program which may be used by the DUMP routine for printing. 


Parameter "c" is an expression that represents an area Of 74 characters 


in the worker program which may be used by the DUMP routine for temporary 
storage. This may be a combined expression. 


The tetrad area is restored after DUMP is used. When the standard print routine 
is not used, the printer base address, line counter, and interrupt entry of 
channel O are not printed correctly. 


b. SNAP Macro 


This instruction provides entry to the DUMP routine in order to print 
a specified portion of memory in a specified mode. 


The SNAP instruction may have any of the following forms: 


LABEL OPERATION OPERANDS 
SNAP 
SNAP a, b 
SNAP ay Dy: A 
SNAP a, DBD, TL 
SNAP ay. Da oR 
SNAP a, Dy Te A 
SNAP a, b, R, A 


A blank operation field will cause the whole memory, including the 
tetrads, to be printed in octal. 


Parameter ."a" and "b" represent, respectively, the lowest and highest 
addresses to be included in the printing. All locations from "a" to 
"b" inclusive will be represented in octal or alphanumeric format. 
Parameters "a" and "b" may have an implied index register. Parameter 
"b" must be greater than "a". 


Parameter "T" will cause the whole tetrad area to be printed in octal 
in addition to the information in locations from "a" to "b". 


Parameter "R" will just print the arithmetic and index registers of 
the tetrad area in addition to the information in locations from "a" 
to “'b", 


Parameter "A" will cause the area from "a" to "b" inclusive to be 
printed in alphanumeric format. 


To switch off SNAP, depress the STOP button and manually insert OO at 
memory location XDUMP + 9. 
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c. Examples 


To illustrate the use of these procedures, assume a program which 
includes a.call for the printer routine. The programmer knows 
that whenever he writes a SNAP line an area of at least 128 char- 
acters labeled WSTR2 will be free and available for use by the 
DUMP procedure. The DUMP line is written as follows: 


SEQUENCE! LABEL 


For BEGIN only. 


OPERATION | ~ OPERANDS 
13 18119 ae 30 j 
PRINT 


pans TR 2 


Assume further that at a certain point in the program the programmer 
wishes to obtain a diagnostic printout, in alphanumeric format, of 

the area of storage from WKAR through WKAR + 39. In addition, the 
programmer desires a printout of the current contents of ARI and 

AR2 and index registers 1 through 7. The SNAP line which accomplishes 
this is written as follows: | 


WKAR, WKAR +3 ,91,,R,,,A 
wees __ aap et 


aera 
SNAP 


2. PCALL and PRIN 
ae PCALL Macro 


This instruction includes in the object program a diagnostic routine 
that will print the value of any designated field. This routine can 
be entered only by the PRIN instruction. The most commonly used 
forms of the PCALL instruction follow: 


OPERATION 


ey A blank operand indicates the absence of a standard print routine 
as part of the worker program and that an area for printing and 
temporary storage will be generated. 


M Parameter "a" must be PRINT if the standard print routine is part 
of the worker program and full lines are to be printed. 


Some additional forms to aid in conserving space are as follows: 


©8UP 3040.40 | PROVISIONAL : 


LABEL : OPERATION . OPERANDS 


PCALL a, b 
PCALL ay 3 C 
PCALL , b 
PCALL , b, Cc 
PCALL rr C 


Parameter "a" is as mentioned above. 


—Bseparameter "b" is an expression that addresses an area of 128 
characters or more in the worker program that can be used by 
the PCALL routine for printing. 


M Parameter "c" is an expression that addresses an area of 65 


characters or more in the worker program that can be used by 
the PCALL routine for temporary storage. 


b. PRIN Macro 


This instruction, which must be used in conjunction with the PCALL 


instruction, causes the value of a field to be printed unconditionally 


or Only when a specified condition exists. 


The PRIN instruction may have any of the following forms: 


LABEL OPERATION OPERANDS 


a, b, c 


M Parameter "a" specifies unconditional or conditional printing. 
If conditional printing is desired, parameter "a" is either EB, 
UB, GB, or SB*, if binary comparisons are to be made; it is ED, 
UD, GD, or SD,** if decimal comparisons are to be made. If un- 
conditional printing is desired, parameter "a" is AL and para- 
meter "c" is omitted. Printing will occur for: 


* Equal Binary; Unequal Binary; Greater Binary; Smaller Binary. 


 **Equal Decimal; Unequal Decimal; Greater Decimal; Smaller Decimal. 
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a, b, ac, a Conditional 
Print 


AL, b, a Unconditional 
Print 


EB, ED when the value of Db 
UB, UD when the value of b 
GB, GD when the value of b 
SB, SD when the value of b 


NV, Il 
Aaa a 


=| Parameter "b" is the label of the field to be compared; it is also 
the field that is printed if the condition is met. If this field 
exceeds 16 characters, only the 16 least significant positions are 
used. An index register may also be implied. 


@ Parameter "c" is the label of the constant used in the comparison. 
Tt must be one of the data generation forms. 


ee Parameter "d" is an expression that allows the user to identify the 
lines being printed. It is normally the label specified by para- 
meter b enclosed in quotes, used as a constant to print on the line. 
If this parameter is omitted, the word PRINT will be printed. 


The PRINT format follows: 


LABEL ADDRESS VALUE VALUE CONSTANT CONSTANT 
ta" of the Alpha- Alpha- 
or | value numeric Octal numeric Octal 
PRINT 


c. Examples 


It is desired to print the results of the inventory amount contained in 
a field addressed by INV3 whenever it exceeds the maximum amount con- 
tained in a constant labeled K3. It is also desired to identify this 
amount when printed. In addition, regardless of whether INV3 is 
printed or not, it is desired to print the contents of INV7. The 
following coding will accomplish the desired results. 


| SEQUENCE | LABEL 
Peale uh 


For BEGIN only. 


OPERATION OPERANDS 
Lc eae] 18}19 


GD, 


bN, Vio pul 3) INV 3° 


AL, |INV7 =, ° N V7 ° 


The printed result will be 


LABEL ADDRESS VALUE (ALPHANUMERIC) VALUE (OCTAL) CONSTANT CONSTANT 
: (ALPHANUMERIC) (OCTAL) 
INV3 704 ~ 00785 01421 | 00783 01417 
3. REPL 


This instruction enables the programmer to replace certain computed results 
with predicted results and thus continue to test portions of a program 
beyond one that is not functioning properly. This enables one program test 
run to uncover several program errors and provides more efficient use of 
the computer for debugging. The form of the REPL instruction follows: 
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LABEL OPERATION OPERANDS 


REPL Lys Vir LgreeerLy, Vn 


where L; is the label addressing the field that receives the constant Vj. 
A maximum of 5 fields (n<5) is allowed for each REPL line. 


NOTE: 
L; must be a label with an implied length. 


Vy must be <¢ 16 characters in length and must follow 
the rules for data generation. 


Example: 


It is desired to have the value of a field labeled RATE preset to the 
value of 78 prior to entering a section of a program. The present 
contents of the field RATE are the results of previous computations in 
the program and may be in error if those sections contain programming 
errors. Normally it would be desirable to see the present contents of 
RATE before it is changed by the REPL macro. The coding to do this 
might appear as follows: 


For BEGIN only. 


SEQUENCE | LABEL || [OPERATION OPERANDS 
ye 34 51617 Lifwli3 wig 8 
oy i ES ECO ECT a 


Po Ree are 7 


Execution of these macros will cause the printing of the value contained 
in the field RATE and will also change this value to 78. RATE must be a 
label vw'th a defined field ee 
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